home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 18 / CU Amiga Magazine's Super CD-ROM 18 (1997)(EMAP Images)(GB)[!][issue 1998-01].iso / CUCD / Programming / AmigaE / Src / Utils / Ag2Txt / Ag2Txt_v2.readme < prev    next >
Encoding:
Text File  |  1994-08-16  |  1.8 KB  |  41 lines
  1. Short: AmigaGuide to text (v2). E & C source.
  2. Type: text/hyper
  3. Uploader: m88jrh@uk.ac.ox.ecs (Jason R. Hulance)
  4. Author: m88jrh@uk.ac.ox.ecs (Jason R. Hulance)
  5.  
  6. Ag2Txt (v2)
  7. ===========
  8. Ag2Txt converts AmigaGuide files to highlighted text.  This text may be
  9. read using a standard text reader, or may be sent to a suitable printer.
  10. (The Amiga printer drivers handle the ANSI codes produced.)
  11.  
  12. There are three different versions of this program in the archive: two
  13. written in E (one for AmigaDOS 1.3 and one for 2.0+), and one in C. All
  14. three versions have the following syntax:
  15.  
  16.     ag2txt <amigaguidefile> [ <textfile> ]
  17.  
  18. The <textfile> is an optional output file.  If it is not specified or
  19. cannot be opened then the output is written to the terminal (stdout).
  20.  
  21. Version 2 of Ag2Txt knows a lot more AmigaGuide codes and handles them a
  22. lot better than version 1.  Also, version 1 omitted the C version, which
  23. was subsequently requested by a number of people.
  24.  
  25. You can customise the output by fiddling with the source.  The ansi codes
  26. used are confined to the function 'write_ansi' near the top of the source.
  27. One list is for turning on the appropriate attribute, and the second is
  28. for turning it off.  The C version is particularly dumb because the Xterms
  29. I use at work don't understand the 'turn off' codes so I took them out
  30. (and used just the 'set to plain' code, '\e[0m').
  31.  
  32. The AmigaDOS 2.0+ version uses the buffered I/O functions to gain a huge
  33. performance increase compared to the unbuffered I/O used in the AmigaDOS
  34. 1.3 version.  Also, the 2.0+ version uses Michael Zucchi's excellent
  35. 'async' module that comes with E v3.0 to get an extra 1/3 speed up (for
  36. reading, since 'async' doesn't do writes... yet??).
  37.  
  38. Legal stuff:
  39. The programs in this archive are Copyright (C) 1994, Jason R. Hulance.
  40. Apart from that the GNU Public License (Version 2) holds.
  41.